home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / symm.z / symm
Encoding:
Text File  |  2002-10-03  |  6.7 KB  |  159 lines
  1. SYMM(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSYYMMMM, DDSSYYMMMM, CCSSYYMMMM, ZZSSYYMMMM - Multiplies a real or complex general
  6.      matrix by a real or complex symmetric matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSYYMMMM ((_s_i_d_e,, _u_p_l_o,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,, _l_d_c))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDSSYYMMMM ((_s_i_d_e,, _u_p_l_o,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,, _l_d_c))
  16.  
  17.      Complex
  18.  
  19.         CCAALLLL CCSSYYMMMM ((_s_i_d_e,, _u_p_l_o,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,, _l_d_c))
  20.  
  21.      Double complex
  22.  
  23.         CCAALLLL ZZSSYYMMMM ((_s_i_d_e,, _u_p_l_o,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,, _l_d_c))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      SSSSYYMMMM and DDSSYYMMMM multiply a real general matrix by a real symmetric
  30.      matrix.
  31.  
  32.      CCSSYYMMMM and ZZSSYYMMMM multiply a complex general matrix by a complex
  33.      symmetric matrix.
  34.  
  35.      These routines perform one of the following matrix-matrix operations:
  36.  
  37.           C <- alpha AB + beta C
  38.  
  39.           or
  40.  
  41.           C <- alpha BA + beta C
  42.  
  43.      where alpha and beta are scalars, _A is a symmetric matrix, and _B and _C
  44.      are _m-by-_n matrices.
  45.  
  46.      These routines have the following arguments:
  47.  
  48.      _s_i_d_e      Character*1.  (input)
  49.                Specifies whether the symmetric matrix _A appears on the left
  50.                or right in the operation, as follows:
  51.  
  52.                _s_i_d_e = 'L' or 'l':  C <- alpha AB + beta C
  53.                _s_i_d_e = 'R' or 'r'; C <- alpha BA + beta C
  54.  
  55.      _u_p_l_o      Character*1.  (input)
  56.                Specifies whether the upper or lower triangular part of the
  57.                symmetric matrix _A is referenced, as follows:
  58.  
  59.                _u_p_l_o = 'U' or 'u':  only the upper triangular part of the
  60.                symmetric matrix is referenced.
  61.                _u_p_l_o = 'L' or 'l':  only the lower triangular part of the
  62.                symmetric matrix is referenced.
  63.  
  64.      _m         Integer.  (input)
  65.                Specifies the number of rows in matrix _C.  _m must be >= 0.
  66.  
  67.      _n         Integer.  (input)
  68.                Specifies the number of columns in matrix _C.  _n must be >=
  69.                0.
  70.  
  71.      _a_l_p_h_a     Scalar factor.  (input)
  72.                SSSSYYMMMM: Real.
  73.                DDSSYYMMMM: Double precision.
  74.                CCSSYYMMMM: Complex.
  75.                ZZSSYYMMMM: Double complex.
  76.  
  77.      _a         Array of dimension (_l_d_a,_k_a).  (input)
  78.                SSSSYYMMMM: Real array.
  79.                DDSSYYMMMM: Double precision array.
  80.                CCSSYYMMMM: Complex array.
  81.                ZZSSYYMMMM: Double complex array.
  82.                When _s_i_d_e = 'L' or 'l', _k_a is _m; otherwise, it is _n.
  83.                Contains the matrix _A.
  84.  
  85.                Before entry with _s_i_d_e = 'L' or 'l', the _m-by-_m part of
  86.                array _a must contain the symmetric matrix _A, such that:
  87.  
  88.                * If _u_p_l_o = 'U' or 'u', the leading _m-by-_m upper triangular
  89.                  part of array _a must contain the upper triangular part of
  90.                  the symmetric matrix.  The strictly lower triangular part
  91.                  of _a is not referenced.
  92.  
  93.                * If _u_p_l_o = 'L' or 'l', the leading _m-by-_m lower triangular
  94.                  part of array _a must contain the lower triangular part of
  95.                  the symmetric matrix.  The strictly upper triangular part
  96.                  of _a is not referenced.
  97.  
  98.                Before entry with _s_i_d_e = 'R' or 'r', the _n-by-_n part of
  99.                array _a must contain the symmetric matrix _A, such that:
  100.  
  101.                * If _u_p_l_o = 'U' or 'u', the leading _n-by-_n upper triangular
  102.                  part of array _a must contain the upper triangular part of
  103.                  the symmetric matrix.  The strictly lower triangular part
  104.                  of _a is not referenced.
  105.  
  106.                * If _u_p_l_o = 'L' or 'l', the leading _n-by-_n lower triangular
  107.                  part of array _a must contain the lower triangular part of
  108.                  the symmetric matrix.  The strictly upper triangular part
  109.                  of _a is not referenced.
  110.  
  111.      _l_d_a       Integer.  (input)
  112.                Specifies the first dimension of _a as declared in the
  113.                calling program.  When _s_i_d_e = 'L' or 'l', _l_d_a >= MMAAXX(1,_m);
  114.                otherwise, _l_d_a >= MMAAXX(1,_n).
  115.  
  116.      _b         Array of dimension (_l_d_b,_n).  (input)
  117.                SSSSYYMMMM: Real array.
  118.                DDSSYYMMMM: Double precision array.
  119.                CCSSYYMMMM: Complex array.
  120.                ZZSSYYMMMM: Double complex array.
  121.  
  122.                Contains the matrix _B.  Before entry, the leading _m-by-_n
  123.                part of array _b must contain matrix _B.
  124.  
  125.      _l_d_b       Integer.  (input)
  126.                Specifies the first dimension of _b as declared in the
  127.                calling program.  _l_d_b >= MMAAXX(1,_m).
  128.  
  129.      _b_e_t_a      Scalar factor.  (input)
  130.                SSSSYYMMMM: Real.
  131.                DDSSYYMMMM: Double precision.
  132.                CCSSYYMMMM: Complex.
  133.                ZZSSYYMMMM: Double complex.  When _b_e_t_a is supplied as 0, _c need
  134.                not be set on input.
  135.  
  136.      _c         Array of dimension (_l_d_c,_n).  (input and output)
  137.                SSSSYYMMMM: Real array.
  138.                DDSSYYMMMM: Double precision array.
  139.                CCSSYYMMMM: Complex array.
  140.                ZZSSYYMMMM: Double complex array.
  141.  
  142.                Contains the matrix _C.  Before entry, the leading _m-by-_n
  143.                part of array _c must contain matrix _C, except when _b_e_t_a is
  144.                0; in which case, _c need not be set.  On exit, the _m-by-_n
  145.                updated matrix overwrites array _c.
  146.  
  147.      _l_d_c       Integer.  (input)
  148.                Specifies the first dimension of _c as declared in the
  149.                calling program.  _l_d_c >= MMAAXX(1,_m).
  150.  
  151. NNOOTTEESS
  152.      These routines are Level 3 Basic Linear Algebra Subprograms (Level 3
  153.      BLAS).
  154.  
  155. SSEEEE AALLSSOO
  156.      HHEEMMMM(3F)
  157.  
  158.      This man page is available only online.
  159.